Oracle WebCenter Sites集約REST APIリファレンス

アセット・タイプによるアセットの検索

get

/resources/v1/search/types/{assetType}/assets

リソース・エンドポイントは、指定されたアセット・タイプに基づいたすべてのアセットのリストを返します。
これは、コレクション・リソースです。

次の表に、クライアント・リクエストをまとめます。

パス・パラメータ

名前	説明	形式
assetType	アセット・タイプ	文字列

問合せパラメータ

名前	説明	形式
countonly	ブール値を受け入れます。trueに設定すると、件数のみ表示され、結果は返されません。デフォルトはfalseです。	ブール
field:[fieldname]:[operation]	指定した演算を使用した[fieldname]のフィールドに対する問合せ条件を指定します。[Operation]はオプションで、equals、range、startswith、phrase、wildcard、similarまたはcontainsのいずれかを指定できます。デフォルトはcontainsです。range演算については、値の書式は{lower bound}:{upper bound}(たとえば、1:10)です。	文字列
fields	各検索結果の属性名のカンマ区切りのリストを受け入れます。デフォルトでは、各検索結果の名前と説明のみ返されます。	文字列
limit	返されるアイテムの合計数を指定します。	数値
links	リンク名のカンマ区切りのリストを受け入れます。デフォルトでは、このパラメータですべてのリンク(next、prev、first、last、schema、selfおよびcanonicalリソース)が返されます。	文字列
offset	結果を返す開始地点となる開始索引を指定します。	数値
orderBy	結果のソート基準になるフィールドを指定します。使用方法: orderBy=[fieldname]:[asc/des]。注意: Luceneでは、トークン化されていない索引付けフィールドのみソートできます。	文字列
q	問合せ文字列を指定します。これは、構成時に指定された検索エンジン固有の問合せです。(デフォルトの検索エンジンはLuceneです。)	文字列
searchengine	検索に使用する検索エンジンを指定します。デフォルトの検索エンジンはLuceneです。	文字列
totalResults	ブール値を受け入れます。trueに設定すると、レスポンスに結果総数フィールドが表示されます。デフォルトはfalseです。	ブール

次の表に、サーバー・レスポンスをまとめます。

サポートされるメディア・タイプ

application/json
application/xml

200レスポンス

アセット・タイプに基づいたすべてのアセットのリスト

次の例に、cURLを使用してRESTリソースに対するGETリクエストを送信し、WebCenter Sitesで最初の3つのAVIArticle名を名前の昇順で取得する方法を示します。REST URLで、nextリンクのみを返すことも指定します。

問合せパラメータの詳細:

"limit=3": 3つの結果のみ必要です。'offset'が指定されていないため、デフォルトは0です。
"fields=name": アセットの名前のみ必要です。
"orderBy=name:asc": 名前の昇順。
"links=next": nextリンクのみ表示されます。

curl -i -H "Accept: application/json" -X GET "http://<host>:<port>/<context>/REST/resources/v1/search/types/AVIArticle/assets?fields=name&orderBy=name:asc&limit=3&links=next"

レスポンス・ヘッダーの例

次の例に、レスポンス・ヘッダーを示します。

Cache-Control: max-age=0 
ETag: "003bc74182f0edfa060603663a8839311cd8c2a4b8e57f1d7fd33d85c2fa0d1c" 
Content-Type: application/json;charset=utf-8

レスポンス本文の例

次の例に、JSON形式のレスポンス本文のコンテンツを示します。

{
  "offset": 0,
  "limit": 100,
  "count": 3,
  "hasMore": true,
  "links": [
    {
      "href": "http://<host>:<port>/<context>/REST/resources/v1/search/types/AVIArticle/assets?limit=3&orderBy=name:asc&links=next&fields=name&offset=3",
      "rel": "next",
      "templated": false,
      "mediaType": "",
      "method": "",
      "profile": ""
    }
  ],
  "items": [
    {
      "name": "10 Important Baseball Rules for beginners",
      "link": {
        "href": "",
        "rel": "assetReference",
        "templated": false,
        "mediaType": "",
        "method": "GET",
        "profile": ""
      },
      "id": "AVIArticle:1330881074927"
    },
    {
      "name": "100 Meter Sprint Versus A Marathon",
      "link": {
        "href": "",
        "rel": "assetReference",
        "templated": false,
        "mediaType": "",
        "method": "GET",
        "profile": ""
      },
      "id": "AVIArticle:1363104065090"
    },
    {
      "name": "25 Nevada Resorts Serving Snow",
      "link": {
        "href": "",
        "rel": "assetReference",
        "templated": false,
        "mediaType": "",
        "method": "GET",
        "profile": ""
      },
      "id": "AVIArticle:1328196047338"
    }
  ]
}